home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / pmqwk006.zip / PMQWK.DOC < prev    next >
Text File  |  1993-01-04  |  45KB  |  973 lines
  1.                                      Oberon PMQWK Offline Mailreader
  2.                                  ** BETA ** Version 1.00, Release #6
  3.                                                      4 January, 1993
  4.  
  5.                                                      Oberon Software
  6.                                                518 Blue Earth Street
  7.                                           Mankato, MN 56001-2142 USA
  8.  
  9.                                                  Voice: 507-388-7001
  10.                                                  Fax:   507-388-7568
  11.                                                  BBS:   507-388-1154
  12.  
  13.                                             Fidonet:        1:292/60
  14.                                            MCI Mail: oberon/413-5847
  15.                                                 CIS:      72510,3500
  16.                                               GEnie:       B.FLOWERS
  17.  
  18.  
  19.                         ** CAUTION ***
  20.  
  21. The accompanying software is a BETA TEST version.  It is NOT
  22. guaranteed to be complete or free from defects.  This software and
  23. documentation are subject to change and do not in anyway imply a
  24. commitment on the part of Oberon Software or the author.
  25.  
  26. If you use this software, you do so at your own risk.  Oberon
  27. Software will not be liable for any losses or damages to property,
  28. data, time, or business which arise as the direct or indirect result
  29. of the use, misuse, or failure to be able to use this software or
  30. documentation.  Your acceptance of these terms is implied by your use
  31. of this software and documentation.
  32.  
  33. Although this is a BETA TEST version, Oberon Software has released
  34. this version for wide distribution.  All of the above disclaimers
  35. apply and you are cautioned to not use this software if you do not
  36. agree to the disclaimers in this file.  Your use of this software
  37. will imply your acceptance.  You are free to distribute this package
  38. as you would any other shareware program under the provision that
  39. no changes are made in any way to the software or the accompanying
  40. documentation and that the entire package, complete with this
  41. documentation is distributed together as a unit.
  42.  
  43. If, while using this software, you should discover any program errors
  44. or omissions which are not otherwise mentioned in this document
  45. (please read "Features and Functions Absent in this BETA TEST
  46. Version" below before submitting a problem report), please contact
  47. Oberon Software by one of the methods given above and alert us to the
  48. existence of the problem so that it may be corrected.  If the problem
  49. results in a system error popup (i.e., a TRAP 000D or other system
  50. trap) please make note of the values of "CS" and "IP" from the system
  51. error display.  Also, please indicate the version and release number
  52. of the software which experienced the problem.
  53.  
  54.   ┌────────────────────────────────────────────────────────────────┐
  55.   │ Contact for bug reports and enhancements requests:             │
  56.   │                                                                │
  57.   │   Oberon BBS or OS/2 Shareware BBS to Kimberly Bobrow          │
  58.   │   Fidonet to Kimberly Bobrow at either 1:141/261 or 1:292/60   │
  59.   │   Internet to Kimberly.Bobrow@hnews.fidonet.org                │
  60.   │   Voice phone: 212-465-3367                                    │
  61.   └────────────────────────────────────────────────────────────────┘
  62.  
  63.  
  64.                       **** CONTENTS ****
  65.  
  66.         Caution
  67.  
  68.         I. Overview
  69.  
  70.         II. Installation
  71.           A. Files
  72.           B. First time startup
  73.             1. Paths and Options
  74.             2. Your first QWK packets
  75.  
  76.         III. Using PMQWK
  77.           A. Unpacking QWK packets
  78.           B. Reading messages
  79.             1. The "List" function
  80.             2. The "Copy" function
  81.             3. The "Replies" conference
  82.           C. Replying to messages
  83.             1. The editor
  84.               a. Word Wrap
  85.             2. Messages which are not replies
  86.           D. Packaging replies for upload
  87.           E. The Address Book
  88.             1. Copying information to the Envelope window
  89.           F. Options
  90.             1. Fonts
  91.             2. Colors
  92.             3. Paths
  93.             4. Editor
  94.             5. Preferences
  95.               a. Beep on personal messages
  96.               b. Attribute quotes
  97.               c. Wrap Column for Quotes
  98.               d. Prepend "Re:" to response subject lines
  99.               e. Strip existing "Re:" from subject lines
  100.               f. Prev/Next buttons on right in message reader
  101.               g. Use Taglines
  102.               h. Use PMQWK Cutline
  103.               i. Show only active conferences
  104.             6. Save options
  105.             7. Icons
  106.  
  107.  
  108.                         **************
  109.  
  110. I.   Overview
  111.  
  112. PMQWK is a 32-bit, Presentation Manager (tm) based program for use
  113. with OS/2 version 2.0 or later.  Its purpose is to facilitate the
  114. reading and reply process for messages downloaded from bulletin
  115. boards and other sources which employ the "QWK" format for mail
  116. packets.
  117.  
  118. You may use PMQWK to:
  119.  
  120.   Unpack new QWK mail packets which have been downloaded from a
  121.   bulletin board or other service into a format which is readable
  122.   by PMQWK.  QWK packets from any arbitrary number of bulletin
  123.   boards or services may be examined simultaneously.
  124.  
  125.   Read your unpacked messages.  Each bulletin board or service may
  126.   transmit any number of messages, grouped into 'conferences', and
  127.   all are handled via a tree-like mechanism within PMQWK. Any number
  128.   of conferences for any number of bulletin boards may be opened
  129.   simultaneously within PMQWK.
  130.  
  131.   Reply to any message or enter new messages into a conference and
  132.   prepare them for retransmission to the bulletin board or service.
  133.   PMQWK handles such things as quoting the original message,
  134.   attributing quotes, maintaining reply links and other bookkeeping
  135.   details while you use the editor of your choice to edit the replies
  136.   or messages.
  137.  
  138.   Entire messages or portions of messages may be saved to alternate
  139.   files either directly or via the system clipboard or may be
  140.   integrated via the clipboard into other documents or files.
  141.  
  142.   Pack replies and messages into a format suitable for
  143.   retransmission to the bulletin board or service.
  144.  
  145.   PMQWK currently supports the following compression programs for
  146.   purposes of packing and unpacking mail packets: PKZIP2 (and PKUNZIP2),
  147.   LH2 (LHArc for OS/2) and ARC2 (SEA ARC for OS/2).  More will be
  148.   added in the near future.
  149.  
  150.  
  151. PMQWK will NOT do the following:
  152.  
  153.   Upload or download QWK mail packets to and from the bulletin boards
  154.   and/or on-line services.  A separate telecommunications program is
  155.   required for this purpose.  We recommend Oberon Software's Terminal
  156.   Emulator/2 (TE/2) as a good, general purpose, terminal program for
  157.   use with PMQWK and with OS/2 in general.
  158.  
  159.   Pack or unpack QWK mail packets without the presence of at least
  160.   one archiving program on your system.  Archiving schemes are, in
  161.   some cases, proprietary to the vendor of the archiving software and,
  162.   in almost all cases, subject to change at the vendors discretion.
  163.   For this reason, PMQWK relies on the presence of one or more of the
  164.   following programs on your system: PKZIP (and PKUNZIP) from PKWare,
  165.   LH2 (LHArc for OS/2), or ARC2 from System Enhancement Associates.
  166.   (PLEASE NOTE: the INFOZIP utilities for zipping and unzipping files
  167.   are NOT recommended for use with PMQWK as they lack a key command
  168.   line feature which PMQWK requires.  We will address this
  169.   limitation in PMQWK in a future release.)
  170.  
  171.   PMQWK does not include a built-in message editor.  Most everyone
  172.   has his or her favorite text editor and, at the very least, all
  173.   installations of OS/2 should have E.EXE. PMQWK will use E.EXE by
  174.   default but you may specify the editor of your choice and it will
  175.   be automatically invoked for you.
  176.  
  177.  
  178. Features and Functions absent in this BETA TEST Version:
  179.  
  180.   *******************************************************************
  181.   This version of PMQWK is tested on OS/2 2.0 "GA" and OS/2 2.0
  182.   with the Service Pack (XR6055) installed only.  We have experienced
  183.   problems running this version of PMQWK under the OS/2 2.1 BETA
  184.   release dated 12/9/92 and do NOT recommend using it in this
  185.   environment until we have determined the cause of these problems.
  186.   *******************************************************************
  187.  
  188.   Paths are not checked for validity in the "Paths" dialog nor are
  189.   the specified archive programs checked for validity at this point.
  190.   The paths and programs ARE checked for existence and/or validity
  191.   before an attempt is made to use any of these however.  This feature
  192.   will be enabled before General Release.
  193.  
  194.   Memory allocation checking is not complete in this version of
  195.   PMQWK.  It is possible to "run out of memory" by opening too many
  196.   conferences and cause PMQWK to abend with a protection violation.
  197.   Define "too many conferences" in the vicinity of ten or more.  This
  198.   feature will be made bulletproof before General Release.
  199.  
  200.   The Color Settings dialog is not fully functional in this release;
  201.   it is not possible to change the color of highlighted text in
  202.   message displays although the setting for it appears in the dialog.
  203.   This feature may or may not be enabled before General Release.
  204.  
  205.   The settings for PMQWK allow you to specify paths for ZOO and UNARJ
  206.   as packer/unpackers but neither of these programs are supported for
  207.   actual use by this release of PMQWK.
  208.  
  209.   An automated setup procedure will be added before General Release.
  210.  
  211.   The current method of setting personalized icons for BBSes and
  212.   conferences is completely manual and infers a certain amount of
  213.   skill with the file system on the part of the user.  This procedure
  214.   will be automated and simplified.
  215.  
  216.   PMQWK will not always sense when an archiving program has problems
  217.   packing or unpacking a file.  If a new packet is mysteriously
  218.   creating problems, try unpacking the QWK packet by hand to see if
  219.   it might be a damaged file.  Error checking here will be made
  220.   more robust before General Release.
  221.  
  222.   Because this is a BETA TEST release, we expect that you may
  223.   encounter other program omissions or errors.  Please alert Oberon
  224.   Software to these problems as you encounter them.
  225.  
  226.   ┌────────────────────────────────────────────────────────────────┐
  227.   │ For bug reports and enhancements requests:                     │
  228.   │                                                                │
  229.   │   Oberon BBS or OS/2 Shareware BBS to Kimberly Bobrow          │
  230.   │   Fidonet to Kimberly Bobrow at either 1:141/261 or 1:292/60   │
  231.   │   Internet to Kimberly.Bobrow@hnews.fidonet.org                │
  232.   │   Voice phone: 212-465-3367                                    │
  233.   └────────────────────────────────────────────────────────────────┘
  234.  
  235.  
  236. Other important notes and considerations:
  237.  
  238.   As mentioned above, the INFOZIP packing and unpacking utilities are
  239.   not supported in this release of PMQWK.
  240.  
  241.   Certain editors will cause problems with PMQWK.  The OS/2 Enhanced
  242.   Editor (EPM.EXE) will work correctly with PMQWK if and only if
  243.   there are no other copies of EPM running on your machine at the
  244.   time you begin an edit session via PMQWK (this includes other PMQWK
  245.   edit sessions).  The IBM IUO editor, LXPM, does not function
  246.   correctly for use with PMQWK.
  247.  
  248.   If you have used an earlier (16-bit) beta version of PMQWK, you MUST
  249.   delete your PMQWK.INI file before running this version and then use
  250.   the current version to reset your options.
  251.  
  252.  
  253. II.  Installation
  254.  
  255.   A. Files
  256.  
  257.   For best results, a dedicated directory should be made for PMQWK.
  258.   We suggest that you make a directory, on the disk of your choice,
  259.   by the name PMQWK and copy PMQWK.EXE and TagLines.txt into that
  260.   directory.  You should ensure that this directory is your current
  261.   working directory while you are running PMQWK as PMQWK will maintain
  262.   subdirectories for each bulletin board underneath this directory.
  263.  
  264.   Copy the file REGEXPUT.DLL into a directory named in the LIBPATH
  265.   statement from your CONFIG.SYS.
  266.  
  267.   Install PMQWK into PM or WPS as you deem fit.  As mentioned above,
  268.   you should ensure that the directory containing PMQWK.EXE is the
  269.   designated "Working Directory" for executing PMQWK however.
  270.  
  271.   B. First time startup
  272.  
  273.     1. Paths and Options
  274.  
  275.   You may start PMQWK from the OS/2 command line by first ensuring
  276.   that the disk and directory containing PMQWK are current and typing
  277.   "PMQWK" at the system prompt.  If you have installed PMQWK into
  278.   your desktop setup (following the rules for current directory) you
  279.   may start it that way.
  280.  
  281.   Example batch file for starting PMQWK assuming that it is installed
  282.   in to directory 'D:\PMQWK':
  283.  
  284.     @echo off
  285.     D:
  286.     CD \PMQWK
  287.     START /PM /N PMQWK
  288.  
  289.   Example of the first page of the 'Settings' Notebook for a PMQWK
  290.   installation assuming that it is installed into directory
  291.   'D:\PMQWK':
  292.  
  293.    ┌──┬──────────────────────────────────────────────────────┬──┬──┐
  294.    │  │ PMQWK Offline Mail Reader - Settings                 │  │  │
  295.    ├──┴──────────────────────────────────────────────────────┴──┴──┤
  296.    │┌────────────────────────────────────────────────┐             │
  297.    ││                                                │┐            │
  298.    ││                                                ││┐           │
  299.    ││                                                │Program      │
  300.    ││                                                ││││          │
  301.    ││                                                ││Session     │
  302.    ││ Required                                       ││││          │
  303.    ││   Path and file name:                          │││Assocation │
  304.    ││   ┌───────────────────────┐   ┌───────┐        ││││          │
  305.    ││   │D:\PMQWK\PMQWK.EXE     │   │Find...│        ││││General   │
  306.    ││   └───────────────────────┘   └───────┘        ││││          │
  307.    ││                                                ││││          │
  308.    ││ Optional                                       ││││          │
  309.    ││   Parameters:                                  ││││          │
  310.    ││   ┌───────────────────────────────────┐        ││││          │
  311.    ││   │                                   │        ││││          │
  312.    ││   └───────────────────────────────────┘        ││││          │
  313.    ││   Working directory:                           ││││          │
  314.    ││   ┌───────────────────────────────────┐        ││││          │
  315.    ││   │D:\PMQWK                           │        ││││          │
  316.    ││   └───────────────────────────────────┘        ││││          │
  317.    ││                                                ││││          │
  318.    ││ ┌───────┐   ┌───────┐                          ││││          │
  319.    ││ │ Undo  │   │ Help  │                          ││││          │
  320.    ││ └───────┘   └───────┘                          ││││          │
  321.    ││                                             < >││││          │
  322.    │└────────────────────────────────────────────────┘│││          │
  323.    │ └────────────────────────────────────────────────┘││          │
  324.    │  └────────────────────────────────────────────────┘│          │
  325.    │   └────────────────────────────────────────────────┘          │
  326.    │                                                               │
  327.    │                                                               │
  328.    └───────────────────────────────────────────────────────────────┘
  329.  
  330.  
  331.  
  332.   Immediately upon entering PMQWK for the first time, select the menu
  333.   item labeled "Options" and the submenu item labeled "Paths".  Set
  334.   the following items:
  335.  
  336.     Inbound QWK Packets: set this item to the name of the directory
  337.     in which new QWK packets will appear after they have been
  338.     downloaded from the BBS or on-line services.  In general, this
  339.     will be the download directory which your telecommunications
  340.     program uses although you may wish to create a new directory
  341.     specifically for this purpose and move QWK packets into this
  342.     directory by other means after they have been downloaded. [NOTE:
  343.     in this version of PMQWK the validity of this path is NOT checked
  344.     at this point.]
  345.  
  346.     Outbound Reply Packets: set this item to the name of the
  347.     directory where you wish PMQWK to deposit packaged reply packets
  348.     to be uploaded back to the BBS or on-line service.  In general,
  349.     this will be a directory in which your telecommunications
  350.     program expects to find files for upload.  [NOTE: in this version
  351.     of PMQWK the validity of this path is NOT checked at this point.]
  352.  
  353.  
  354.     Packers and Unpackers: fill in as many of these as are applicable
  355.     with the drive, path, and name of the appropriate archiving
  356.     program or programs.  If they exist in a directory referred to in
  357.     your PATH environment variable, you may omit the drive and path
  358.     specification and give only the name of the program file.  [NOTE:
  359.     in this version of PMQWK, these programs names and paths are NOT
  360.     checked for validity at this point. FURTHER NOTE: in this version
  361.     of PMQWK, only the first three archivers are supported:
  362.     PK(UN)ZIP, ARC, and LH.  Entries exist for ARJ and ZOO for future
  363.     use only, they are not used by this version of PMQWK.]
  364.  
  365.  
  366.   [General note for beta release version: the previous three items
  367.   have disclaimers stating that validity on these items are not
  368.   checked during this dialog.  The validity IS checked later at
  369.   appropriate points.  If your "InBound" path is invalid or if you
  370.   have specified no valid archiver programs, PMQWK will find nothing
  371.   suitable for unpacking when that option is selected.  If your
  372.   "OutBound" path is invalid, PMQWK will default to the current
  373.   directory for this function after alerting you to the problem.  If
  374.   no valid archivers have been specified by the time you select the
  375.   option to package reply packets, PMQWK will alert you to the
  376.   problem.]
  377.  
  378.   [Further note: As mentioned above, the INFOZIP utilities for
  379.   zipping and unzipping files are not supported in this release of
  380.   PMQWK.]
  381.  
  382.   After setting the paths, you may investigate the other items on the
  383.   "Options" menu for setting your favorite editor as default, setting
  384.   colors and fonts, and other options or you may leave these settings
  385.   for later.
  386.  
  387.   After setting at least your "Paths", select "Save Options" from the
  388.   "Options" menu and your setup will be saved. [Technical note:
  389.   options are not saved in the system files; a file named PMQWK.INI
  390.   will be made in the same directory as PMQWK.EXE.]  If you attempt
  391.   to exit PMQWK before you have saved your options, PMQWK will query
  392.   you for this.
  393.  
  394.  
  395.     2. Your first QWK packets
  396.  
  397.   If you do not have any QWK packets available, you must first access
  398.   a bulletin board or on-line service and obtain at least one QWK mail
  399.   packet.
  400.  
  401.   Make sure that all QWK mail packet in which you are interested are
  402.   in the directory which you specified as your "InBound" path above.
  403.  
  404.   If you have exited PMQWK, restart the program now.
  405.  
  406.   Select "Unpack QWK Packet" from the menu.  A dialog will appear
  407.   listing the valid QWK packets which were found in your "InBound"
  408.   directory.  Select the packet in which you are interested and press
  409.   the OK button.  The QWK packet will be unpacked and the name of the
  410.   BBS should appear now in the "BBS List" window.  Repeat this
  411.   procedure for all packets which you wish to unpack.
  412.  
  413.   [Note: the first time you start PMQWK with a valid "InBound" path,
  414.   or the first time you select "Unpack QWK Packet" with a valid
  415.   "InBound" path, there may be some delay as PMQWK scans the inbound
  416.   directory for the first time.  This delay will only be significant
  417.   if there are many files matching the pattern "*.qw*" in that
  418.   directory.  Only "new files" are scanned so the delay should not
  419.   be significant on subsequent invocations.]
  420.  
  421.  
  422. III. Using PMQWK
  423.  
  424.   A. Unpacking QWK packets
  425.  
  426.   Make sure that any and all QWK packets in which you are interested
  427.   are located in the directory which you specified as your "InBound"
  428.   path (see section II.B.1 above).  Select "Unpack QWK Packet" from
  429.   the menu or press the "Unpack" button in the "BBS List" dialog
  430.   window.  You will be presented with a list of valid QWK packets
  431.   which PMQWK was able to locate in your "InBound" directory.  Select
  432.   one to unpack either by double clicking on the file name and info
  433.   or by selecting it and pressing the "OK" button.  The packet will
  434.   now be unpacked (if you are about to overwrite another packet,
  435.   you will be given to opportunity to abort the action).  Repeat this
  436.   procedure for every QWK packet you wish to unpack.
  437.  
  438.   If you have never unpacked a packet from this source before, a new
  439.   item will appear in the "BBS List" window at this point.
  440.  
  441.  
  442.   B. Reading messages
  443.  
  444.   To begin the process of reading messages, first select a BBS from
  445.   the "BBS List" window (if this list is empty, you must first unpack
  446.   at least one QWK packet! See "Unpacking QWK packets" above).  After
  447.   selecting a BBS, another dialog will appear which will list the
  448.   available conferences for that BBS.  Conferences which contain
  449.   messages will be indicated with a '+' sign in this list while empty
  450.   conferences will have a '-' as the first character.  Each
  451.   conference also has an indication, in parentheses, of how many
  452.   message are available and your "current position" in the list.  For
  453.   example:
  454.  
  455.                 +4/Netmail (5/15)
  456.  
  457.   indicates that area #4, called "Netmail" has messages, that it has
  458.   fifteen messages and that you will enter viewing the fifth message.
  459.  
  460.   Please note that, by default, areas which contain no messages (and
  461.   would thus have a '-' as the first character in their listing, are
  462.   not shown at all.  To enable their visibility, use the
  463.   "Preferences" dialog and toggle the checkbox labeled "Show only
  464.   active conferences" to OFF.
  465.  
  466.   When you select a conference to view, you will be presented with a
  467.   window which contains a "message header" at the top of the window,
  468.   a scrollable region in the central area containing the message
  469.   text, and a set of buttons at the bottom of the window for
  470.   initiating various activities.
  471.  
  472.   The "message header" contains the following information: the
  473.   message number, the number of the message it refers to (if any),
  474.   the position in the list of messages (in our example above, it
  475.   would read "#5 of 15"), the sender's name, the addressee's name, the
  476.   subject of the message, its time and date stamp, whether it is
  477.   a private or public message, and whether the bulletin board has
  478.   marked this message as "Seen by you" or not.  If this is a net
  479.   mail message, the sender's net address will be given after his/her
  480.   name in parentheses.
  481.  
  482.   Most of the activities are self-explanatory: "Next" and "Prev" will
  483.   view the next and previous message in the conference respectively,
  484.   "Quit" closes the window, "Help" invokes the help display (NOTE:
  485.   "Help" is NOT active in this BETA release!).  "Reply" and "Enter"
  486.   will invoke the reply editor (see "Replying to messages" below) the
  487.   difference being that "Reply" will preset much of the reply header
  488.   information with data from the current message while "Enter" will
  489.   begin the creation of a new, unrelated (as least as far as the QWK
  490.   format is concerned) message.  The other two functions deserve a
  491.   little more information which follows immediately.
  492.  
  493.  
  494.     1. The "List" function
  495.  
  496.   This invokes a dialog window which, initially contains a list of
  497.   all messages in the area, their message number, subject, sender,
  498.   receiver, and time/date.  Messages addressed to you are marked with
  499.   an asterisk "*".  You may select a message from this list and press
  500.   the "OK" button to go immediately to that message.
  501.  
  502.   The "Filter" button in this dialog allows you to view a subset of
  503.   the messages in the list.  You may search for text in "envelope"
  504.   fields (Sender, Receiver, and Subject) or in the message body
  505.   itself.
  506.  
  507.   The filtering is for purposes of the "List" dialog only, it does
  508.   not affect the behavior of the message window at all (except as
  509.   regards jumping to a message).
  510.  
  511.  
  512.     2. The "Copy" function
  513.  
  514.   You may mark areas within the message text using the mouse pointer
  515.   and copy them to the system clipboard using CONTROL+INSERT or you may
  516.   use the "Copy" dialog.  This dialog allows you to refine how you
  517.   export the data to a greater degree.  You may chose to copy the
  518.   entire message or just the marked area (if any), you may optionally
  519.   include header information about the message in the export, and you
  520.   may copy it directly to a file or to the system clipboard.
  521.  
  522.  
  523.     3. The "Replies" conference
  524.  
  525.   There is one extra, pseudo-conference which appears at the
  526.   beginning of each BBS's conference list named "Replies".  This is
  527.   where all of your entered messages and replies will be kept until
  528.   they are packed for retransmission to the BBS.  It behaves in most
  529.   ways exactly like a "normal" message window. However, the "Reply" and
  530.   "Enter" functions are replaced with "Edit" and "Delete".  "Edit"
  531.   will allow you to reedit the message, possibly just the "envelope"
  532.   information or the entire message text, while "Delete" will erase
  533.   the currently viewed reply.
  534.  
  535.   If this is a netmail message, the Receiver's net address will
  536.   appear in parentheses after his/her name.
  537.  
  538.  
  539.  
  540.   C. Replying to messages
  541.  
  542.   To reply to a message, simply invoke the "reply" button while you
  543.   are viewing the message in question.  The message will be placed
  544.   into a file in "quoted" form and your editor will be invoked on
  545.   that file.  You may edit any part of this file and/or append to the
  546.   file.  While your editor is in the process of editing the reply, a
  547.   new icon will appear in the main client window. "Active Edit
  548.   Sessions" contains a list of all current invocations of the editor
  549.   and a button which will allow you immediately switch to any of the
  550.   listed editor sessions.
  551.  
  552.   When you finish editing your reply, you will be returned to PMQWK
  553.   and given the opportunity to edit the "Envelope" information.  This
  554.   will already have your name, the receivers name, net address (if
  555.   applicable), the conference for the message, and the subject filled
  556.   in.  You may edit any of these items except your own name.  If
  557.   "TagLines" are enabled (see "Options") you may select a tagline to
  558.   use from this dialog.
  559.  
  560.   If you press "OK" and all of the required fields are filled in, the
  561.   reply will be saved.  If you press "Cancel" the message will be
  562.   discarded after you confirm that this is your desire.
  563.  
  564.   Should you need to reedit a reply message or delete a reply message,
  565.   invoke the "Replies" pseudo-confernce and perform the desired
  566.   action from there (see "The "Replies" Conference" above).
  567.  
  568.  
  569.     1. The editor
  570.  
  571.   By default PMQWK will invoke E.EXE, the OS/2 system editor to edit
  572.   your replies and other outgoing messages.  If you have an editor
  573.   which you prefer to use, use the "Editor" dialog from the "Options"
  574.   menu (see "Options" below) to specify your editor of choice.
  575.  
  576.  
  577.       a. Word Wrap
  578.  
  579.   Because messages are reformatted based on your setting for "Wrap
  580.   Column" both when quoting a message before a reply and when
  581.   importing your message from the editor back into PMQWK, you should
  582.   be aware of the algorithm used for message formatting so that you
  583.   can achieve a pleasing result.
  584.  
  585.   The message formatter is paragraph based.  It assumes that a new
  586.   paragraph has started when it encounters either a blank line or
  587.   an indented line.  It will pull the entire paragraph together
  588.   to make a "best fit" within your defined wrap column.  For example,
  589.   assuming you have the (unlikely) wrap setting of 30, the following
  590.   text:
  591.  
  592.                     |---|----|----|----|----|----|
  593.                     Now is the time for all good men to
  594.                     come to the aid
  595.                     of their country.
  596.  
  597.   would be reformatted as:
  598.  
  599.                     |---|----|----|----|----|----|
  600.                     Now is the time for all good
  601.                     men to come to the aid of
  602.                     their country.
  603.  
  604.   While the following:
  605.  
  606.                     |---|----|----|----|----|----|
  607.                     Table data:
  608.                         Column 1       Column 2
  609.                         --------       --------
  610.                         Apples         Oranges
  611.  
  612.   would not be reformatted at all because of the indentation.  If you
  613.   are not aware of the way this behaves, you may end up with
  614.   undesirable results.  For instance, if you entered the following:
  615.  
  616.                     |---|----|----|----|----|----|
  617.                     Hello Joe!
  618.                     Whatcha know?
  619.                     I just got back from Kokomo!
  620.                     Yours truly,
  621.                     Ira
  622.  
  623.   it would end up looking like:
  624.  
  625.                     |---|----|----|----|----|----|
  626.                     Hello Joe! Whatcha know? I
  627.                     just got back from Kokomo!
  628.                     Yours truly, Ira
  629.  
  630.   Use blank lines and indentation to avoid having lines pulled back
  631.   for you when you don't want this to happen.
  632.  
  633.  
  634.     2. Messages which are not replies
  635.  
  636.   Sometimes you may wish to enter a message which is not a reply to
  637.   any existing message.  There are two ways to do this: via the
  638.   "Enter" button while viewing a conference, and via the "Message"
  639.   button from the Conference List dialog.  In both cases, the
  640.   procedure that follows is almost exactly that of creating a reply
  641.   message with the following exceptions:
  642.  
  643.     * The "Envelope" dialog will appear both before AND after you
  644.       edit the message.
  645.  
  646.     * No default information is filled in in the "Envelope" dialog
  647.       the first time; you must specify all fields.
  648.  
  649.   Otherwise, for all intents and purposes, a message of this sort is
  650.   treated exactly like any other reply.
  651.  
  652.  
  653.  
  654.   D. Packaging replies for upload
  655.  
  656.   Select "Pack Replies" from the menu or press the "Pack" button is
  657.   the "BBS List" dialog window.  You will be presented with a
  658.   list of all BBSes which have unpacked reply messages defined. 
  659.   Select one or more from this list and press "OK".
  660.  
  661.   For each selection from the previous list, you will be given a
  662.   dialog wherein you may select the archiver to use for packaging
  663.   this reply packet and, if a file by the target name already exists
  664.   in your "OutBound" directory, the option of overwriting that file
  665.   or appending the new messages to it.
  666.  
  667.   There are possibly two buttons in this dialog labeled "List
  668.   Replies"; one which always appears and another which will only be
  669.   present if there already exists a reply packet in your "OutBound"
  670.   path.  This second button appears inside of a group box labeled
  671.   "Existing Replies" in this case.  The first of these buttons will
  672.   provide a list of "Reply Headers" (the conference number, receiver,
  673.   and subject) for each message in the group of new messages the
  674.   second will do the same for the existing replies.  Note, if the
  675.   existing reply packet was not created using PMQWK, PMQWK will not
  676.   attempt to list its contents.
  677.  
  678.   The button labeled "Change Path" will invoke a dialog wherein you
  679.   may override the currently set "OutBound" path (or reset it to the
  680.   default value if you have changed it).
  681.  
  682.   Press the "OK" button to begin the packing process, press "Cancel"
  683.   to abort the process.
  684.  
  685.  
  686.   E. The Address Book
  687.  
  688.   The address book feature of PMQWK is activated by choosing "Address
  689.   Book" from the "Files" menu in the main client window of PMQWK. 
  690.   This is a small database wherein you may keep an organized list
  691.   of names, netmail addresses, and notes for future reference.
  692.  
  693.   Each data record in the Address Book consists of four fields:
  694.   a 'Search key', and 'Name', and a 'Net Address', each of which may
  695.   be up to 25 characters long plus a 'Notes' field which can hold
  696.   up to 949 characters of information.
  697.  
  698.   The reason for having the 'Key' field separate from the 'Name'
  699.   field is so that you may enter the name as it is to appear in
  700.   your reply envelopes (i.e., Name: "Barney Rubble") and still have
  701.   your list sorted by something other than first name (i.e.,
  702.   Search Key: "Rubble, Barney").
  703.  
  704.   There are five buttons in the Address Book window, each of which
  705.   will initiate an action.  'Close' will close the address book
  706.   window, 'New' will insert a new, empty record and place the
  707.   Address Book in edit mode for that record, 'Edit' will place the
  708.   address book into edit mode for the currently viewed record,
  709.   'Delete' will delete the currently displayed record (NOTE WELL:
  710.   in the BETA release of the program, the user is NOT queried at
  711.   this point whether or not to really delete the record!), and
  712.   'Help' will display help for the Address Book functions (NOTE:
  713.   in this BETA release, the 'Help' button is not active.).
  714.  
  715.   By default, the Address Book comes up in 'lookup mode'.  You may
  716.   view the details for any entry by either selecting its key from
  717.   the listbox at the left of the window or by typing the first
  718.   character or characters of the key into the entry field labeled
  719.   'Search Key' in the upper left of the window.  The latter performs
  720.   an 'incremental search' through the list of keys, that is, if you
  721.   type 'F', the listbox highlight moves to the first entry which
  722.   begins with an 'F' (this is not case sensitive), if you then
  723.   proceed to type an 'L', the highlight moves to the first entry
  724.   in the listbox which begins with 'FL'.
  725.  
  726.   You enter 'edit mode' by pressing either the 'New' button or the
  727.   'Edit' button.  The 'New' button inserts a new, blank record and
  728.   allows you to edit that record; the 'Edit' button is only available
  729.   if a valid record is currently displayed and it allows you to edit
  730.   the currently viewed record.
  731.  
  732.   In 'edit mode', the listbox is replaced with a short, informational
  733.   message and all four of the entry fields (Search key, Name, Net
  734.   Addr, and Notes) will now accept input.  You may type anything into
  735.   these fields you wish; you may use all of the standard OS/2 editing
  736.   keys and clipboard functions (i.e., Shift+Delete, Ctrl+Insert, and
  737.   Shift+Insert for Cut, Copy, and Paste).  To save the record as
  738.   edited, press the "Save" button, to cancel changes press the
  739.   "Cancel" button (NOTE: in this BETA release of the program, the
  740.   "Help" button is not active).  If you have edited the 'Search Key',
  741.   the listbox in the 'view mode' window will be rearranged as needed.
  742.  
  743.   1. Copying information to the Envelope window
  744.  
  745.   As mentioned above, the OS/2 editing keys which allow you to access
  746.   the system clipboard are active, that is, you may 'Mark' the name
  747.   in the Address Book with the mouse or the keyboard, copy it to
  748.   the clipboard (Ctrl+Insert) and paste it into any OS/2 application
  749.   which will accept clipboard data.  This, of course, includes the
  750.   the fields in PMQWK's Envelope windows.  For direct communication
  751.   with the Envelope window, however, you may elect to use the built-in
  752.   "Drag and Drop" interface.
  753.  
  754.   If you press and hold Mouse Button Two (usually the right mouse
  755.   button) while the mouse pointer is over the 'Name" field or field
  756.   label in the Address Book window, the mouse pointer will change
  757.   into a small rectangle with the word "NAME" in it.  Still holding
  758.   mouse button two, move the mouse pointer to the Envelope window
  759.   in which you wish this name to appear until the superimposed circle
  760.   with a slash disappears and release the mouse button.  The name
  761.   will replace whatever text is currently in the "To:" field in the
  762.   envelope window.  If you begin this operation from the "Net Addr"
  763.   field or field label in the Address Book window, the mouse pointer
  764.   will instead read "NET" and the data will be placed into the "Net:"
  765.   field in the envelope window.  If you begin from anywhere else in
  766.   in the Address Book window other than directly over the above
  767.   mentioned fields or their labels, the mouse pointer will appear as
  768.   two rectangles, "NAME" and "NET", and the data will go to both
  769.   fields in the Envelope window.  To cancel the drag and drop
  770.   operation, simply release the mouse button anywhere where it DOES
  771.   have the circle-slash visible.
  772.  
  773.   There is no corresponding drag and drop mechanism for copying data
  774.   from the Envelope into the Address Book in this release of PMQWK.
  775.   You may, of course, use the system clipboard to accomplish this as
  776.   outlined above.
  777.  
  778.  
  779.   F. Options
  780.  
  781.   There are several user settable options which you may specify via
  782.   the various items on the "Options" menu.
  783.  
  784.     1. Fonts
  785.  
  786.   This dialog will allow you to set the fonts which PMQWK will use
  787.   for message displays and list boxes.
  788.  
  789.  
  790.     2. Colors
  791.  
  792.   This dialog will allow you to set the colors which PMQWK will use
  793.   for message displays and list boxes. [NOTE: In this BETA release
  794.   of PMQWK, entries appear for "Message HiLited Text" and "Message
  795.   HiLited Text Background".  These setting are NOT functional in this
  796.   release, the highlighted colors in message displays are a function
  797.   of the normal, non-hilighted colors.]
  798.  
  799.  
  800.     3. Paths
  801.  
  802.   This topic has already been covered elsewhere in this document. 
  803.   Please refer to Section II.B.1 for information on these settings.
  804.  
  805.  
  806.     4. Editor
  807.  
  808.   You may select your editor of choice here for purposes of editing
  809.   reply messages.  Type the name of the editor in the indicated
  810.   field, if the program file is not in a directory referred to in
  811.   your PATH environment variable, you must include the entire drive
  812.   and path specification for the program.  Once you have specified
  813.   a valid program name here you will be given the opportunity to
  814.   select how the program will be executed, i.e., as a Presentation
  815.   Manager program, in a full screen session, or in a windowed
  816.   session.
  817.  
  818.  
  819.     5. Preferences
  820.  
  821.   Preferences is a catchall for a number of semi-related settings.
  822.  
  823.       a. Beep on personal messages
  824.  
  825.   If this setting is checked, PMQWK will alert you with a tone
  826.   whenever you view a message addressed to you.
  827.  
  828.       b. Attribute quotes
  829.  
  830.   If this setting is checked, you specify that you want PMQWK to
  831.   provide an "Attribution" to the quotes in your reply messages and
  832.   you may further specify how you wish this Attribution to appear.
  833.   Type any text you wish into the associated entry field and it will
  834.   be echoed into your reply messages.  There are several special
  835.   character sequences which you may embed into this text which will
  836.   cause PMQWK to insert relevant information from the message header:
  837.  
  838.     %s inserts the SENDER's name from the original message
  839.     %r inserts the RECEIVER's name from the original message
  840.     %j inserts the SUBJECT of the original message
  841.     %d inserts the DATE of the original message
  842.     %t inserts the TIME of the original message
  843.     %_ inserts a line break in the attribution string
  844.     %% is used to insert a '%' character in the string.
  845.  
  846.   Please note, these codes ARE case sensitive!  "%S" will NOT work
  847.   like "%s", instead it will simply insert the characters "%S" into
  848.   the attribution string.
  849.  
  850.  
  851.       c. Wrap Column for Quotes
  852.  
  853.   The column at which lines will be broken for purposes of quoting
  854.   original messages.  PMQWK attempts to be intelligent about word
  855.   boundaries and will try to wrap lines at word breaks.
  856.  
  857.  
  858.       d. Prepend "Re:" to response subject lines
  859.  
  860.   Automatically place the characters "Re: " at the beginning of
  861.   subjects lines in replies.  "Re: " will NOT be prepended if those
  862.   characters are already present at the beginning of the subject.
  863.  
  864.  
  865.       e. Strip existing "Re:" from subject lines
  866.  
  867.   Remove the characters "Re:" and any white space following from
  868.   subject lines in replies.  Note that this option and the previous
  869.   are NOT mutually exclusive!  If they are both checked, subject
  870.   lines in replies will always contain one and only one "Re:", if
  871.   neither is checked, no subject line is ever altered by PMQWK.
  872.   Note further that you have the ability to add or remove any
  873.   characters you wish from a subject line via the "Envelope"
  874.   dialog; these setting are provided as a convenience.
  875.  
  876.  
  877.       f. Prev/Next buttons on right in message reader
  878.  
  879.   You may prefer it if the "Next" and "Prev" buttons appeared on the
  880.   right side of the message reader window and closer to the scroll
  881.   bars which govern the message text.  If so, set this option ON.
  882.   Be warned, however, that if you move the focus in this window
  883.   using the TAB or arrows keys that the focus will appear to move
  884.   out of order with respect to these buttons!
  885.  
  886.  
  887.       g. Use Taglines
  888.  
  889.   If this option is checked, PMQWK will look in the same directory
  890.   that contains the PMQWK.EXE file for a file named "TagLines.txt".
  891.   If it is found it will use this for it's source of tag lines
  892.   (humorous or provocative short quotes which will be appended to
  893.   your outgoing messages) and the "TagLine" drop-down list will
  894.   be enabled in the various "Envelope" dialogs.  From there you
  895.   may select a line from the list, type in a fresh one "on the fly",
  896.   or erase it entirely.
  897.  
  898.   The TagLines.txt file is a flat ASCII file containing one tagline
  899.   per line of file; you may edit this file with any text editor.
  900.   Taglines should not be longer than about 60 or 70 characters.
  901.  
  902.  
  903.       h. Use PMQWK Cutline
  904.  
  905.   If this option is set OFF then PMQWK will not append it's own
  906.   "signature line" to your outgoing messages.
  907.  
  908.  
  909.       i. Show only active conferences
  910.  
  911.   If this option is set ON (the default), PMQWK will only display
  912.   those conference names belonging to conferences containing more
  913.   than zero messages in the "Conference List" dialog.  Use this
  914.   setting if you have a large number of empty conferences listed
  915.   by a BBS and you do not wish to navigate past them to find the
  916.   active areas.
  917.  
  918.  
  919.     6. Save options
  920.  
  921.   All options discussed in this section may be saved
  922.   semi-permanently in an initialization file by selecting this
  923.   option.  You may always change an option again and resave it.
  924.   If you change options and do not select "Save options" before
  925.   you attempt to exit PMQWK, you will be alerted to this fact and
  926.   given the opportunity to do so at that point.
  927.  
  928.   Options are saved in a file named PMQWK.INI in the same directory
  929.   as PMQWK.EXE.  If you've really made a mess of your settings and
  930.   wish to "start from scratch" just delete this file while PMQWK is
  931.   not running and restart the program (see section II.B.1 for first
  932.   time startup directions).
  933.  
  934.     7. Icons
  935.  
  936.   Though not on any menu within this version of PMQWK, you may
  937.   specify your own custom icons and attach them to any "BBS
  938.   Conference List" dialog or to any "Conference" dialog.  You must
  939.   use OS/2 version 1.3 compatible color or black and white icon
  940.   files (.ICO).  To do this, create a directory underneath the
  941.   directory containing PMQWK.EXE named "PMQIcons" and place all of
  942.   your custom icon files in this directory.  PMQWK will determine
  943.   how to use these icons by the names you give the files:
  944.  
  945.     To attach an icon to a BBS (Conference List Dialog) give the
  946.     icon file the same "first name" as the BBS id and an extension
  947.     of .ICO.  (Example: A BBS id might be "FERNWOOD", name the
  948.     icon file "FERNWOOD.ICO").
  949.  
  950.     To attach an icon to a specific conference for a specific BBS,
  951.     use the same first name as above but give the file an extension
  952.     which is the conference number, left padded to three characters
  953.     with zeros (Example: to attach an icon to conference #5 for the
  954.     "FERNWOOD" BBS, name the icon file "FERNWOOD.005").
  955.  
  956.     To attach an icon to the "Personal Messages" conference, do as
  957.     above but give the icon file the extension ".PER".  To attach
  958.     it to the "Replies" pseudo-conference, give it the extension
  959.     ".ANS".
  960.  
  961.   [NOTE: This procedure will be built into the program and made more
  962.   easy for the average user in the future.  Do not attempt this
  963.   procedure if the above discussion made little or no sense to you!]
  964.  
  965.  
  966.  
  967.  
  968. Happy Mail Reading!
  969. Brady Flowers
  970. Oberon Software
  971. 4 January, 1993
  972.  
  973.